Create(RenderTarget,CompatibleRenderTargetOptions,Nullable<Size2F>,Nullable<Size2L>,Nullable<PixelFormat>) メソッド

現在の描画ターゲットと互換性のある、中間のオフスクリーン描画中に使用するビットマップ描画ターゲットを作成します。

シンタックス

Visual Basic
C#

'宣言
 
Public Overloads Shared Function Create( _
   ByVal renderTarget As RenderTarget, _
   ByVal options As CompatibleRenderTargetOptions, _
   ByVal desiredSize As System.Nullable(Of Size2F), _
   ByVal desiredPixelSize As System.Nullable(Of Size2L), _
   ByVal desiredFormat As System.Nullable(Of PixelFormat) _
) As BitmapRenderTarget

public static BitmapRenderTarget Create( 
   RenderTarget renderTarget,
   CompatibleRenderTargetOptions options,
   System.Nullable<Size2F> desiredSize,
   System.Nullable<Size2L> desiredPixelSize,
   System.Nullable<PixelFormat> desiredFormat
)

パラメータ

renderTarget: RenderTarget のインスタンス。
options: 新しい描画ターゲットが GDI と互換性があるかどうかを指定する値。
desiredSize: 元の描画ターゲットと異なる必要がある場合の、新しい描画ターゲットの希望のサイズ (デバイスに依存しないピクセル単位)。詳細については、「備考」セクションを参照してください。
desiredPixelSize: 元の描画ターゲットと異なる必要がある場合の、新しい描画ターゲットの希望のサイズ (ピクセル単位)。詳細については、「備考」セクションを参照してください。
desiredFormat: 新しい描画ターゲットの必要なピクセル形式とアルファモード。ピクセル形式が DXGI_FORMAT_UNKNOWN に設定される場合、新しい描画ターゲットは元の描画ターゲットと同じピクセル形式を使用します。アルファモードが AlphaMode.Unknown の場合、新しい描画ターゲットのアルファモードはデフォルトで D2D1_ALPHA_MODE_PREMULTIPLIED に設定されます。サポートされるピクセル形式の詳細については、{{サポートされているピクセル形式とアルファモード}} を参照してください。

解説

新しい描画ターゲットのピクセルサイズと DPI は、desiredSize またはdesiredPixelSize の値を指定して変更できます。desiredSize が指定されていても、desiredPixelSize が指定されていない場合、ピクセルサイズは、親ターゲット DPI を使用して目的のサイズから計算されます。DesiredSize が整数ピクセルのサイズにマップされる場合、互換性のある描画ターゲットの DPI は親ターゲットの DPI と同じになります。DesiredSize が小数ピクセルのサイズにマップされる場合、ピクセルサイズは最も近い整数に切り上げられ、互換性のある描画ターゲットの DPI は親の描画ターゲットの DPI より高くなります。すべての場合では、座標 (desiredSize.width、desiredSize.height) が互換性のある描画ターゲットの右下隅にマップされます。desiredPixelSize が指定されているが、desiredSize が指定されていない場合、新しい描画ターゲットの DPI は元の描画ターゲットと同じになります。desiredSize とdesiredPixelSize の両方が指定されている場合、スケールの違いを考慮して新しい描画ターゲットの DPI が計算されます。desiredSize もdesiredPixelSize も指定されていない場合、新しい描画ターゲットのサイズと DPI は元の描画ターゲットと一致します。

参照

BitmapRenderTarget クラス
 BitmapRenderTarget メンバ
 オーバーロード一覧